home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / h2ph.z / h2ph
Encoding:
Text File  |  2002-10-03  |  4.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. HHHH2222PPPPHHHH((((1111))))                                                                HHHH2222PPPPHHHH((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      h2ph - convert .h C header files to .ph Perl header files
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      hhhh2222pppphhhh [[[[----dddd ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn ddddiiiirrrreeeeccccttttoooorrrryyyy]]]] [[[[----rrrr |||| ----aaaa]]]] [[[[----llll]]]] [[[[hhhheeeeaaaaddddeeeerrrrffffiiiilllleeeessss]]]]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _h_2_p_h converts any C header files specified to the corresponding Perl
  16.      header file format.  It is most easily run while in /usr/include:
  17.  
  18.              cd /usr/include; h2ph * sys/*
  19.  
  20.      or
  21.  
  22.              cd /usr/include; h2ph -r -l .
  23.  
  24.      The output files are placed in the hierarchy rooted at Perl's
  25.      architecture dependent library directory.  You can specify a different
  26.      hierarchy with a ----dddd switch.
  27.  
  28.      If run with no arguments, filters standard input to standard output.
  29.  
  30. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  31.      -d destination_dir
  32.          Put the resulting ....pppphhhh files beneath ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn____ddddiiiirrrr, instead of
  33.          beneath the default Perl library location
  34.          ($Config{'installsitsearch'}).
  35.  
  36.      -r  Run recursively; if any of hhhheeeeaaaaddddeeeerrrrffffiiiilllleeeessss are directories, then run _h_2_p_h
  37.          on all files in those directories (and their subdirectories, etc.).
  38.          ----rrrr and ----aaaa are mutually exclusive.
  39.  
  40.      -a  Run automagically; convert hhhheeeeaaaaddddeeeerrrrffffiiiilllleeeessss, as well as any ....hhhh files which
  41.          they include.  This option will search for ....hhhh files in all
  42.          directories which your C compiler ordinarily uses.  ----aaaa and ----rrrr are
  43.          mutually exclusive.
  44.  
  45.      -l  Symbolic links will be replicated in the destination directory.  If
  46.          ----llll is not specified, then links are skipped over.
  47.  
  48.      -h  Put ``hints'' in the .ph files which will help in locating problems
  49.          with _h_2_p_h.  In those cases when you rrrreeeeqqqquuuuiiiirrrreeee a ....pppphhhh file containing
  50.          syntax errors, instead of the cryptic
  51.  
  52.                  [ some error condition ] at (eval mmm) line nnn
  53.  
  54.          you will see the slightly more helpful
  55.  
  56.                  [ some error condition ] at filename.ph line nnn
  57.  
  58.          However, the ....pppphhhh files almost double in size when built using ----hhhh.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. HHHH2222PPPPHHHH((((1111))))                                                                HHHH2222PPPPHHHH((((1111))))
  71.  
  72.  
  73.  
  74.      -D  Include the code from the ....hhhh file as a comment in the ....pppphhhh file.  This
  75.          is primarily used for debugging _h_2_p_h.
  76.  
  77. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  78.      No environment variables are used.
  79.  
  80. FFFFIIIILLLLEEEESSSS
  81.       /usr/include/*.h
  82.       /usr/include/sys/*.h
  83.  
  84.      etc.
  85.  
  86. AAAAUUUUTTTTHHHHOOOORRRR
  87.      Larry Wall
  88.  
  89. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  90.      _p_e_r_l(1)
  91.  
  92. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  93.      The usual warnings if it can't read or write the files involved.
  94.  
  95. BBBBUUUUGGGGSSSS
  96.      Doesn't construct the %sizeof array for you.
  97.  
  98.      It doesn't handle all C constructs, but it does attempt to isolate
  99.      definitions inside evals so that you can get at the definitions that it
  100.      can translate.
  101.  
  102.      It's only intended as a rough tool.  You may need to dicker with the
  103.      files produced.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.